화이트 리스트 문서변환 기능
info
화이트 리스트 정책에 따른 문서변환 정책 기능을 수행합니다.
- 매핑 방식은 1:1 방식으로 동작합니다.
- DS 6.0 ENT AppAuth Mode에서만 동작합니다.
1.개요
- DS 6.0 ENT AppAuth Mode에서 특정 맵핑 정책에 따라 문서에 대한 변환 기능을 제공합니다.
- 변환에 대한 정책은 커스텀 정책으로 설정합니다.
- 관련 TFS : TF S37818 - 특정AIP레이블만 변환되는 기능 추가개발 요청
2. 관련 모듈
| 파일명 | 경로 | 버전 | 설명 | 빌드 경로 |
|---|---|---|---|---|
| SCPD_DS365.dll | C:\Windows\Softcamp\sdk\scsa | 6.0.3.10 | 문서보안 이벤트 모듈 | \sctfsbuild.softcamp.co.kr\AzureBuild\2025\DS6.0_VS2019(ZTCA_AIP)| |
| SCPD_DS36564.dll | C:\Windows\Softcamp\sdk\scsa | 6.0.3.10 | 문서보안 이벤트 모듈 | \sctfsbuild.softcamp.co.kr\AzureBuild\2025\DS6.0_VS2019(ZTCA_AIP)| |
3. 관련 커스텀 정책
| ID | DS_MIP_DOC_CONV_WHITE_LIST |
|---|---|
| TYPE | EDIT |
| 정책값 형식 | TARGET_DOC_TYPE:ID |
3-1. 정책 형식 설명
TARGET_DOC_TYPE: 원본 문서의 타입DEST_CONVERT_DOC: 변환의 문서의 타입ID: 문서 식별자 (Ex: MIP 문서 Label ID, 등급문서 혹은 범주문서의 ID)
3-2. 문서 타입 (Type)
| 타입 | 설명 |
|---|---|
MIP | MIP 라벨이 지정된 문서 |
MAC | MAC 문서 |
GRADE | 등급이 있는 문서 |
DAC | 개인 문서 (ID 없음) |
3-3. 문서 ID
- 특정 문서를 식별하기 위한 고유한 ID 값 (예:
MIP:abc123) - DAC 의 경우에는 ID 생략 가능 ( 로그인 사용자의 개인문서로 변환됨 )
3-4. 정책 예시
- ABCD 라는 Label ID를 갖는 MIP문서는 등급 문서 아이디 GRADEID0001 로 만 변환을 허용할 경우
->정책값 : MIP:ABCD|GRADE:GRADEID0001 - 범주문서 아이디 MAC000002 의 문서를 MIP Label ID EFGH로의 변환만 허용 할 경우
->정책값 : MAC:MAC000002|MIP:EFGH - 위의 두 예시 정책 모두 적용시 정책값
->정책값 : MIP:ABCD|GRADE:GRADEID0001;MAC:MAC000002|MIP:EFGH
4. 제약사항
- 해당기 능 사용 시 WhiteList 방식의 정책 변환이므로 정책에 등록되어있지 않은 문서에 대한 변환은 모두 차단됩니다.
- DS 6.0 ENT의 경우 문서보안의 변환 로직을 이용하지 않고 직접 개인, 등급, 범주 문서를 지정하여 변경시 linker 기능을 이용하여 변경하기 때문에 변경된 문서가 linker 문서 아이콘으로 나타날수 있습니다.
5. Troubleshooting
⚠️기능 미 동작시 아래와 같은 사항을 확인하여 어떤 사항에 해당하는지 확인필요
- 탐색기에 SCPD_DS36564.dll이 로드되어있는지 확인 필요
- SCPD_DS36564.dll가 정상적으로 로드되어있는 경우 다운로드 동작시 SDSMonitor 로그에 'DS_MIP_DOC_CONV_WHITE_LIST is valid[1]' 이 수집되는지 확인 valid[0] 인경우 정책값 설정 오류이므로 정책값 확인 필요합니다.
- 해당 로그가 없거나 수집이 되어도 동 작이 안될 경우 SDSMonitor 로그를 수집하여 개발자에게 전달